<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>使用命名空间：基础</title>
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-base.css" />
<link media="all" rel="stylesheet" type="text/css" href="styles/03e73060321a0a848018724a6c83de7f-theme-medium.css" />

 </head>
 <body class="docs"><div class="navbar navbar-fixed-top">
  <div class="navbar-inner clearfix">
    <ul class="nav" style="width: 100%">
      <li style="float: left;"><a href="language.namespaces.definitionmultiple.html">« 在同一个文件中定义多个命名空间</a></li>
      <li style="float: right;"><a href="language.namespaces.dynamic.html">命名空间和动态语言特征 »</a></li>
    </ul>
  </div>
</div>
<div id="breadcrumbs" class="clearfix">
  <ul class="breadcrumbs-container">
    <li><a href="index.html">PHP Manual</a></li>
    <li><a href="language.namespaces.html">命名空间</a></li>
    <li>使用命名空间：基础</li>
  </ul>
</div>
<div id="layout">
  <div id="layout-content"><div id="language.namespaces.basics" class="sect1">
  <h2 class="title">使用命名空间：基础</h2>
  <p class="verinfo">(PHP 5 &gt;= 5.3.0, PHP 7, PHP 8)</p>
  <p class="para">
   在讨论如何使用命名空间之前，必须了解 PHP
   是如何知道要使用哪一个命名空间中的元素的。可以将 PHP 
   命名空间与文件系统作一个简单的类比。在文件系统中访问一个文件有三种方式：
   <ol type="1">
    <li class="listitem">
     <span class="simpara">
     相对文件名形式如 <code class="literal">foo.txt</code>。它会被解析为
     <code class="literal">currentdirectory/foo.txt</code>，其中 currentdirectory
     表示当前目录。因此如果当前目录是
     <code class="literal">/home/foo</code>，则该文件名被解析为 <code class="literal">/home/foo/foo.txt</code>。
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
      相对路径名形式如 <code class="literal">subdirectory/foo.txt</code>。它会被解析为
      <code class="literal">currentdirectory/subdirectory/foo.txt</code>。
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
     绝对路径名形式如 <code class="literal">/main/foo.txt</code>。它会被解析为 <code class="literal">/main/foo.txt</code>。
     </span>
    </li>
   </ol>
   PHP 命名空间中的元素使用同样的原理。例如，类名可以通过三种方式引用：
   <ol type="1">
    <li class="listitem">
     <span class="simpara">
     非限定名称，或不包含前缀的类名称，例如
     <code class="literal">$a=new foo();</code> 或
     <code class="literal">foo::staticmethod();</code>。如果当前命名空间是
     <code class="literal">currentnamespace</code>，foo 将被解析为
     <code class="literal">currentnamespace\foo</code>。如果使用 foo
     的代码是全局的，不包含在任何命名空间中的代码，则 foo 
     会被解析为 <code class="literal">foo</code>。
     </span>
     <span class="simpara">
     警告：如果命名空间中的函数或常量未定义，则该非限定的函数名称或常量名称会被解析为全局函数名称或常量名称。详情参见
     <a href="language.namespaces.fallback.html" class="link">使用命名空间：后备全局函数名称/常量名称</a>。
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
     限定名称,或包含前缀的名称，例如
     <code class="literal">$a = new subnamespace\foo();</code> 或
     <code class="literal">subnamespace\foo::staticmethod();</code>。如果当前的命名空间是
     <code class="literal">currentnamespace</code>，则 foo 会被解析为
     <code class="literal">currentnamespace\subnamespace\foo</code>。如果使用
     foo 的代码是全局的，不包含在任何命名空间中的代码，foo
     会被解析为 <code class="literal">subnamespace\foo</code>。
     </span>
    </li>
    <li class="listitem">
     <span class="simpara">
     完全限定名称，或包含了全局前缀操作符的名称，例如，
     <code class="literal">$a = new \currentnamespace\foo();</code> 或
     <code class="literal">\currentnamespace\foo::staticmethod();</code>。在这种情况下，foo 
     总是被解析为代码中的文字名(literal name)<code class="literal">currentnamespace\foo</code>。
     </span>
    </li>
   </ol>
  </p>
  <p class="para">
   下面是一个使用这三种方式的实例：
   <div class="informalexample">
    <p class="simpara">file1.php</p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace&nbsp;</span><span style="color: #0000BB">Foo</span><span style="color: #007700">\</span><span style="color: #0000BB">Bar</span><span style="color: #007700">\</span><span style="color: #0000BB">subnamespace</span><span style="color: #007700">;<br /><br />const&nbsp;</span><span style="color: #0000BB">FOO&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">1</span><span style="color: #007700">;<br />function&nbsp;</span><span style="color: #0000BB">foo</span><span style="color: #007700">()&nbsp;{}<br />class&nbsp;</span><span style="color: #0000BB">foo<br /></span><span style="color: #007700">{<br />&nbsp;&nbsp;&nbsp;&nbsp;static&nbsp;function&nbsp;</span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">()&nbsp;{}<br />}<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <p class="simpara">file2.php</p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace&nbsp;</span><span style="color: #0000BB">Foo</span><span style="color: #007700">\</span><span style="color: #0000BB">Bar</span><span style="color: #007700">;<br />include&nbsp;</span><span style="color: #DD0000">'file1.php'</span><span style="color: #007700">;<br /><br />const&nbsp;</span><span style="color: #0000BB">FOO&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">2</span><span style="color: #007700">;<br />function&nbsp;</span><span style="color: #0000BB">foo</span><span style="color: #007700">()&nbsp;{}<br />class&nbsp;</span><span style="color: #0000BB">foo<br /></span><span style="color: #007700">{<br />&nbsp;&nbsp;&nbsp;&nbsp;static&nbsp;function&nbsp;</span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">()&nbsp;{}<br />}<br /><br /></span><span style="color: #FF8000">/*&nbsp;非限定名称&nbsp;*/<br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">();&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为函数&nbsp;Foo\Bar\foo&nbsp;<br /></span><span style="color: #0000BB">foo</span><span style="color: #007700">::</span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">();&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为类&nbsp;Foo\Bar\foo&nbsp;的静态方法&nbsp;staticmethod<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">FOO</span><span style="color: #007700">;&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为常量&nbsp;Foo\Bar\FOO<br /><br />/*&nbsp;限定名称&nbsp;*/<br /></span><span style="color: #0000BB">subnamespace</span><span style="color: #007700">\</span><span style="color: #0000BB">foo</span><span style="color: #007700">();&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为函数&nbsp;Foo\Bar\subnamespace\foo<br /></span><span style="color: #0000BB">subnamespace</span><span style="color: #007700">\</span><span style="color: #0000BB">foo</span><span style="color: #007700">::</span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">();&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为类&nbsp;Foo\Bar\subnamespace\foo,<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;以及类的方法&nbsp;staticmethod<br /></span><span style="color: #007700">echo&nbsp;</span><span style="color: #0000BB">subnamespace</span><span style="color: #007700">\</span><span style="color: #0000BB">FOO</span><span style="color: #007700">;&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为常量&nbsp;Foo\Bar\subnamespace\FOO<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<br />/*&nbsp;完全限定名称&nbsp;*/<br /></span><span style="color: #007700">\</span><span style="color: #0000BB">Foo</span><span style="color: #007700">\</span><span style="color: #0000BB">Bar</span><span style="color: #007700">\</span><span style="color: #0000BB">foo</span><span style="color: #007700">();&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为函数&nbsp;Foo\Bar\foo<br /></span><span style="color: #007700">\</span><span style="color: #0000BB">Foo</span><span style="color: #007700">\</span><span style="color: #0000BB">Bar</span><span style="color: #007700">\</span><span style="color: #0000BB">foo</span><span style="color: #007700">::</span><span style="color: #0000BB">staticmethod</span><span style="color: #007700">();&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为类&nbsp;Foo\Bar\foo,&nbsp;以及类的方法&nbsp;staticmethod<br /></span><span style="color: #007700">echo&nbsp;\</span><span style="color: #0000BB">Foo</span><span style="color: #007700">\</span><span style="color: #0000BB">Bar</span><span style="color: #007700">\</span><span style="color: #0000BB">FOO</span><span style="color: #007700">;&nbsp;</span><span style="color: #FF8000">//&nbsp;解析为常量&nbsp;Foo\Bar\FOO<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

   </div>
  </p>
  <p class="para">
   注意访问任意全局类、函数或常量，都可以使用完全限定名称，例如
   <span class="function"><strong>\strlen()</strong></span> 或 <span class="classname"><strong class="classname">\Exception</strong></span> 或
   <code class="literal">\INI_ALL</code>。

   <div class="example" id="example-300">
    <p><strong>示例 #1 在命名空间内部访问全局类、函数和常量</strong></p>
    <div class="example-contents">
     <div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">namespace&nbsp;</span><span style="color: #0000BB">Foo</span><span style="color: #007700">;<br /><br />function&nbsp;</span><span style="color: #0000BB">strlen</span><span style="color: #007700">()&nbsp;{}<br />const&nbsp;</span><span style="color: #0000BB">INI_ALL&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">3</span><span style="color: #007700">;<br />class&nbsp;</span><span style="color: #0000BB">Exception&nbsp;</span><span style="color: #007700">{}<br /><br /></span><span style="color: #0000BB">$a&nbsp;</span><span style="color: #007700">=&nbsp;\</span><span style="color: #0000BB">strlen</span><span style="color: #007700">(</span><span style="color: #DD0000">'hi'</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;调用全局函数strlen<br /></span><span style="color: #0000BB">$b&nbsp;</span><span style="color: #007700">=&nbsp;\</span><span style="color: #0000BB">INI_ALL</span><span style="color: #007700">;&nbsp;</span><span style="color: #FF8000">//&nbsp;访问全局常量&nbsp;INI_ALL<br /></span><span style="color: #0000BB">$c&nbsp;</span><span style="color: #007700">=&nbsp;new&nbsp;\</span><span style="color: #0000BB">Exception</span><span style="color: #007700">(</span><span style="color: #DD0000">'error'</span><span style="color: #007700">);&nbsp;</span><span style="color: #FF8000">//&nbsp;实例化全局类&nbsp;Exception<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

   </div>
  </p>
 </div></div></div></body></html>